cs-senda-sapi
📘 Documentación de la API - cs-senda-sapi
Esta sección describe los atributos y uso del servicio cs-senda-sapi.
💂️ Información Base
- Título de la API: cs-senda-sapi
- Versión: 1.0.0
- URL Base:
https://senda-api-prod.us-e1.cloudhub.io/api/
Reemplaza el segmento de ambiente con: dev
(Desarrollo)qa
(Aseguramiento de Calidad)prod
(Producción)
🔑 Autenticación
Encabezados Requeridos
Encabezado | Tipo | Descripción |
---|---|---|
client_id | String | Identificador único para clientes de API |
- client_id
- Longitud: 32 - 36 caracteres
- Ejemplo:
123e4567-e89b-12d3-a456-426614174000
📌 Este encabezado es requerido en todas las solicitudes.
🔒 Endpoint: Crear Autorización
POST /authorization
- Descripción: Crea una nueva autorización para servicios médicos.
URL Completa
https://senda-api-prod.us-e1.cloudhub.io/api/authorization
Método HTTP
POST
Encabezados Requeridos
client_id: TU_CLIENT_ID
Content-Type: application/json
Autenticación
Aplicación de Client ID
Cuerpo de Solicitud
{
"patientInfo": {
"documentType": "1",
"documentNumber": "1234567890",
"firstName": "John",
"lastName": "Doe",
"birthDate": "1980-05-15",
"gender": "M",
"phone": "3107894561",
"email": "john.doe@example.com"
},
"serviceInfo": {
"serviceType": "1",
"serviceCode": "MED-001",
"description": "General medical consultation",
"urgency": "medium",
"requestDate": "2025-05-01T10:30:00Z"
},
"contractInfo": {
"contractId": "CON-12345",
"planType": "PREMIUM",
"company": "ABC Company"
}
}
Ejemplo de Solicitud
curl -X POST "https://senda-api-prod.us-e1.cloudhub.io/api/authorization" \
-H "client_id: TU_CLIENT_ID" \
-H "Content-Type: application/json" \
-d '{
"patientInfo": {
"documentType": "1",
"documentNumber": "1234567890",
"firstName": "John",
"lastName": "Doe",
"birthDate": "1980-05-15",
"gender": "M",
"phone": "3107894561",
"email": "john.doe@example.com"
},
"serviceInfo": {
"serviceType": "1",
"serviceCode": "MED-001",
"description": "General medical consultation",
"urgency": "medium",
"requestDate": "2025-05-01T10:30:00Z"
},
"contractInfo": {
"contractId": "CON-12345",
"planType": "PREMIUM",
"company": "ABC Company"
}
}'
Ejemplo de Respuesta
{
"authorizationId": "AUTH-987654",
"status": "APPROVED",
"creationDate": "2025-05-01T10:35:22Z",
"expirationDate": "2025-05-31T23:59:59Z",
"message": "Authorization successfully created",
"provider": {
"id": "PROV-001",
"name": "Centro Médico Nacional",
"address": "Avenida Principal #123",
"phone": "6014567890"
}
}
⚠️ Códigos de Error
Código | Descripción | Solución Sugerida |
---|---|---|
400 | Solicitud Incorrecta | Revisar sintaxis de solicitud y parámetros |
401 | No Autorizado | Validar credenciales de autenticación |
404 | No Encontrado | Confirmar la URL del endpoint |
500 | Error Interno del Servidor | Reintentar o contactar soporte técnico |
📞 Soporte
Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.
Correo electrónico: epalma@fgs.co
📅 Información Adicional
- Documentación actualizada por última vez: Agosto 2025
- Para actualizaciones adicionales, consulta el Portal de Exchange de API
Documentación actualizada en julio 2025 por epalma@fgs.co - Edna Nayibe Palma
© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-senda-sapi